home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / tin-1.22 / README.AMI < prev    next >
Text File  |  1995-07-13  |  5KB  |  110 lines
  1. This is the Amiga port of TIN. To use it you will need to do the following:
  2.  
  3. Have appropriate directories assigned (UULIB: UUNEWS:).
  4. Have these environment variables set:
  5.  
  6. NODENAME
  7. USERNAME
  8. REALNAME
  9. HOME
  10. EDITOR
  11.  
  12. TIN only works with a hierarchical news directory. This means you will
  13. need Dillon's UUCP1.16 or higher. TIN has been modified to work with
  14. Dillon's Sendmail & Postnews programs. These take different arguments
  15. from standard UNIX mail and news programs. With release 1.1 PL 9 of TIN
  16. two further environment variables can been defined:
  17.  
  18. TIN_POST (default "uucp:c/postnews %s") and
  19. TIN_MAIL (default "uucp:c/sendmail <%s -f %s").
  20.  
  21. If you set these variables, you can configure TIN for any other news/mail
  22. system. The %s in TIN_POST gets replaced with a filename containing the
  23. news article. TIN_MAIL's first %s is a filename, the second is the userid
  24. of the person sending the mail, and the third (if present), is the userid
  25. of the recipient of the mail.
  26.  
  27. Printing is now available. You will have to edit the .tin/tinrc file to
  28. enable it. The "default_printer" string should be set to "copy PIPE: PRT:"
  29. instead of its default setting. This option has not been added to the
  30. internal menu of configurable options.
  31.  
  32. The editor you use with TIN should not return instantly, so if you are
  33. using CED or TTX (or probably some others too) you will need to also add
  34. in the appropriate options in the environment variable EDITOR (see script
  35. file below) which will force your editor to wait until you've quit the
  36. editor. Unless you have an editor which understands the argument +7 to
  37. mean "start editing at line 7", you should set "Editor Offset" in the
  38. configuration menu (type shift-M) to OFF. An example startup script is
  39. given here (I've renamed tin to tin.exe so you can call this script TIN):
  40.  
  41. ----------------------------------
  42. ; For WB2.0 users, the setenv's can be set's instead. This allows multiple
  43. ; users to run with their own names etc. WB1.3 users have to use setenv.
  44.  
  45. setenv USERNAME fred
  46. setenv REALNAME "Fred Flinstone"
  47. setenv NODENAME bedrock   ; This should be just your node name, not the
  48.                           ; entire domain.
  49. setenv HOME    dh0:news   ; wherever you want your news & index files
  50.                           ; stored
  51. setenv EDITOR  c:ed
  52. stack 40000               ; TIN requires a large stack!
  53. actived                   ; create a new active file
  54. delete uulib:active
  55. rename uulib:newsactive uulib:active
  56. tin.exe                   ; start tin itself
  57. ---------------------------------
  58.  
  59. Actived creates an "active" file. This is a standard file in Unix
  60. environments, but missing from DUUCP. Actived also sets the environment
  61. variable "TIN_GROUPS" to equal the number of newsgroups. This variable
  62. isn't necessary to run TIN, but allows TIN to save some memory. If you
  63. don't wish to run actived before TIN, you may wish to copy TIN_GROUPS
  64. to ENVARC: (WB 2.0+ !!).
  65.  
  66. More options, and use of tin is explained in the file tin.nrf. (The
  67. standard manual page that comes with TIN).
  68.  
  69. The following options have been disabled from the TIN source for the Amiga
  70. version:
  71.  
  72. - Archive extraction. Note that 1.1 PL 9 has now enabled uudecoding and
  73. un-shar'ing of posted archives. This requires "uudecode" and "unshar" to
  74. be in the path.
  75.  
  76. - Shell escape and piping to any shell command.
  77.  
  78. - Ability to change News and Mail directories.
  79.  
  80. - Re-reading of the active file while reading news has been disabled. So has
  81. updating index files in the background (-U option).
  82.  
  83. These options were disabled partly to make TIN easier to port, but also
  84. to make it secure enough to run as a newsreader for a Bulletin Board.
  85.  
  86. A TIND program (for creating/updating index files) exists, and is only any
  87. use on a BBS. To make TIN aware that you are using TIND to update the
  88. index, you must set the environment variable TIND (it doesn't matter what
  89. you set it to!). The index files are by default stored in the UUNEWS:
  90. directory, in a subdirectory called .index (as in UNIX). For performance
  91. reasons, you may wish to change the directory to a different drive. By
  92. setting the environment variable TIN_INDEX, you can force the index files
  93. to be stored in $TIN_INDEX/.index.
  94.  
  95. Another two environment variables LINES and COLUMNS can be set to specify
  96. the size of your screen. Inside an Amiga window this isn't required, as TIN
  97. can query the window size, but once again, if you're running on anything
  98. other than the Amiga's console, this query string won't work. If TIN finds
  99. the LINES and COLUMNS environment variables set, it will not try to query
  100. the window size.
  101.  
  102. If you are planning on using TIN in a multi-user environment, such as with
  103. a BBS, you should take a look at the companion archive to this one, which
  104. is called DLGTIN.LHA. Even though this has been set up explicitly for DLG,
  105. it contains executables and documentation which will be useful for any setup
  106. of this type.
  107.  
  108.  - Mark Tomlinson         (mark@garden.equinox.gen.nz)
  109.    Geoff McCaughan        (geoff@satori.equinox.gen.nz)
  110.